<head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    <title>putimage_alphafilter</title>
    <link rel="stylesheet" type="text/css" href="../../css/index-table.css"/>
</head>
<body>

<pre><font size="4"><a href="../../index.htm">主页</a> / <a href="../index.htm">库函数目录</a> / <a href="index.htm">图像处理</a> / putimage_alphafilter</font>
<font size="4">
<font size="4" color="#0000FF"><strong>功能：</strong></font>

根据一张图像提供的 Alpha，将源图像和目标图像进行混合，并把混合结果写入目标图像。

<font size="4" color="#0000FF"><strong>声明：</strong></font>
<pre><font color=#0000FF>int </font><font color=#008080>putimage_alphafilter</font>(
    <font color=#800080>PIMAGE </font>imgDest,    <font color=#008000>// 目标 IMAGE 对象指针</font>
    <font color=#800080>PCIMAGE </font>imgSrc,    <font color=#008000>// 源 IMAGE 对象指针</font>
    <font color=#0000FF>int </font>xDest,         <font color=#008000>// 绘制位置的 x 坐标</font>
    <font color=#0000FF>int </font>yDest,         <font color=#008000>// 绘制位置的 y 坐标</font>
    <font color=#0000FF>PCIMAGE </font>imgalpha,  <font color=#008000>// 提供透明度(alpha)值的图像</font>
    <font color=#0000FF>int </font>xSrc,          <font color=#008000>// 绘制内容在 IMAGE 对象中的左上角 x 坐标</font>
    <font color=#0000FF>int </font>ySrc,          <font color=#008000>// 绘制内容在 IMAGE 对象中的左上角 y 坐标</font>
    <font color=#0000FF>int </font>widthSrc,      <font color=#008000>// 绘制内容在源 IMAGE 对象中的宽度</font>
    <font color=#0000FF>int </font>heightSrc      <font color=#008000>// 绘制内容在源 IMAGE 对象中的高度</font>
);</pre>
<font size="4" color="#0000FF"><strong>参数：</strong></font>
<b>imgDest</b>
要进行半透明混合的目标图像，如果为 NULL 则表示操作窗口上的图片

<b>imgSrc</b>
要进行半透明混合的源图像，该操作不会改变源图像

<b>xDest, yDest</b>
要开始进行混合的目标图像坐标，该坐标是混合区域的左上角

<b>imgalpha</b>
提供 alpha 值的图像。图像中像素值不再作为颜色，而是取低 8 位(取值范围：0 到 255)作为 alpha 值。

<b>xSrc, ySrc, widthSrc, heightSrc</b>
描述要进行此操作的源图像矩形区域。
如果 widthSrc 和 heightSrc 小于等于 0，则为源图像从(xSrc, ySrc) 至右下角的区域。

<font size="4" color="#0000FF"><strong>返回值：</strong></font>

成功返回 0，否则返回非 0，若 imgDest 或 imgSrc 传入错误，会引发运行时异常。

<font size="4" color="#0000FF"><strong>示例：</strong></font>

（无）。

</font>
</pre>

</body>

